MacAnim Viewer 1.1 displays GL, FLI, FLC, FLX, DL, GIF, JPEG, raw PPM, and PCX/PIC files, and automatically unzips PKUNZIP 2.04g-compatible .zip archives in search of the same. Please note that MacAnim Viewer was built presupposing a 68020 and 32-bit QuickDraw, and that it works best with a color monitor set to display at least 256 colors.
24APR95 Martin Fong (mwfong@std.sri.com)
Menus
ΓÇôFile
• Open… (Command-0)
Allows you to open and view GL, FLI, FLC, FLX, DL, GIF, JPEG, raw PPM, PIC/PCX, and ZIP files. Holding the option key down while selecting this menu item allows you to open any file.
ΓÇó Open Startup File
Allows you to open and view the next document that was dragged-and-dropped to start MacAnim Viewer. This is inactive if all startup documents have been opened or if none were specified.
ΓÇó Close (Command-W)
Closes frontmost image document.
ΓÇó Close All
Closes all image document. This is equivalent to pressing the Option key while dismissing the frontmost document window.
• Save as GL… (Command-S)
Saves frontmost image document as a GL archive with GIF images.
ΓÇó Play (Command-P)
Plays or displays frontmost image document. Press Command-. (period) or Esc to terminate.
ΓÇó Quit (Command-Q)
Exits application.
ΓÇôOptions
• Animation Settings… (Command-= (equals))
 
GL, FLI, and DL Time Scale rescales the playback speeds relative to an animationΓÇÖs default; however, the values must be non-negative.
Expand FLI files in memory expands individual FLI, FLC, and FLX frames into in-memory PICTs when an FLI, FLC, or FLX file is read, trading memory space against animation rendering time.
Rescale DL color maps increases the dynamic range of DL color maps.
Decode small video C converts 640 x 200 PIC bitmaps into 320 x 240 grayscale images when a GL animation is read. If this is not selected, video C images are scaled to 640 x 400 bitmaps.
Image slideshow displays individual images within an animation document when the document is displayed. Single click in the window displays next image, option-click displays previous image. On extended keyboards, you can also use the home/page/arrow keys to navigate through the images.
ΓÇó Loop FLI Animations (Command-L)
Allows you to indefinitely play FLI, FLC, and FLX animations.
• Resize Images… (Command-R)
Allows you to scale all animations and images to fit within a pre-defined area by powers of two. Note that when default scaling is selected, Scale To fit is deactivated.
 
ΓÇó Theater View (Command-T)
Displays image documents centered against a black background.
• Diagnostics… (Command-D)
 
Show Directory, Show Text, Print Codes, Quiet, Verbose, and Image Verbose are used to obtain diagnostic information during the processing of animation files. With the exception of Quiet, most of these options will reduce animation frame rates by writing fairly cryptic messages to the console window.
ΓÇôUnzip
• Select Unzip Folder…
Allows you to select a folder into which unzipped files are extracted. The default is MacAnim Viewer's folder.
• Unzip File…
Allows you to unzip a selected .zip file. However, MacAnim Viewer will not look for animation files in the archive.
ΓÇôWindow
• Show Console…
Shows or hides the console window (which contains diagnostic and debugging information). Please note that you must hide the console window to display an image document or quit the application.
ΓÇó <Image Name>
Allows you to bring the specified image document frontmost.
ΓÇôScripts
This menu is only active for GL archives that contain more than one script. It allows you to select a specific script for playback.
ΓÇ£HiddenΓÇ¥ Feature
If MacAnim Viewer doesn’t display a particular file in the open file dialog, hold down the Option key when selecting “Open…” from the File menu. This will cause MacAnim Viewer to display all files regardless of their file types.
GL Development
To facilitate developing GL scripts, MacAnim Viewer opens files with “.txt” extensions as GRASP scripts. It also attempts to resolve image references as external files if they are not found within a GL archive. However, these files must reside in the same directory as the GL archive (or script) and their names must conform to DOS file naming conventions. Also, when a GL animation is frontmost, holding the Command key down while selecting Open… from the File menu allows you to add another script to the animation.
Credits
The GRASP part of this work is derived from Patrick J. NaughtonΓÇÖs xgrasp distribution, copyright (c) 1991. The FLI decoding software was adapted from Ron Schnell's <ronnie@sos.com> xflick distribution. The DL decoding software is originally from George Phillips <phillips@cs.ubc.ca> dltogl.c code. UnZip software is from the UnZip 5.x distribution from Info-ZIP (info-zip@wkuvx1.bitnet). FLI/FLC/DL debug hints and enhancements are from Mark Podlipec's <podlipec@wellfleet.com> xanim 2.6x distributions. This software is based in part on the work of the Independent JPEG Group and on Jef PoskanzerΓÇÖs PBMPlus package. This help dialog is based upon James W. WalkerΓÇÖs <76367.2271@compuserve.com> show_help code.
Finally, thanks to the small and dedicated set of beta testers.